package com.ruoyi.teaching.service;

import java.util.List;
import java.util.Map;

import com.ruoyi.teaching.domain.YaHighInterview;

/**
 * 高频面试题Service接口
 *
 * @author ruoyi
 * @date 2025-09-03
 */
public interface IYaHighInterviewService {
    /**
     * 查询高频面试题
     *
     * @param id 高频面试题主键
     * @return 高频面试题
     */
    public YaHighInterview selectYaHighInterviewById(Long id);

    /**
     * 查询高频面试题列表
     *
     * @param yaHighInterview 高频面试题
     * @return 高频面试题集合
     */
    public List<YaHighInterview> selectYaHighInterviewList(YaHighInterview yaHighInterview);

    /**
     * 新增高频面试题
     *
     * @param yaHighInterview 高频面试题
     * @return 结果
     */
    public int insertYaHighInterview(YaHighInterview yaHighInterview);

    /**
     * 修改高频面试题
     *
     * @param yaHighInterview 高频面试题
     * @return 结果
     */
    public int updateYaHighInterview(YaHighInterview yaHighInterview);

    /**
     * 批量删除高频面试题
     *
     * @param ids 需要删除的高频面试题主键集合
     * @return 结果
     */
    public int deleteYaHighInterviewByIds(Long[] ids);

    /**
     * 删除高频面试题信息
     *
     * @param id 高频面试题主键
     * @return 结果
     */
    public int deleteYaHighInterviewById(Long id);

    /**
     * 批量导入es
     */
    void exportEs();

    int queryExportEsProgress();

    /**
     * 查询相关面试题（根据课程设计ID和课程内容）
     *
     * @param courseDesignId 课程设计ID
     * @param courseContent  课程内容
     * @return 相关面试题信息
     */
    Map<String, Object> queryRelatedInterview(Long courseDesignId, String courseContent);

    /**
     * 根据关键词查询面试题
     *
     * @param keywords 关键词列表
     * @return 面试题列表
     */
    List<YaHighInterview> queryRelatedInterviewByKeywords(List<String> keywords);

    /**
     * 保存课程设计与面试题的关联关系
     *
     * @param courseDesignId 课程设计ID
     * @param interviewIds   面试题ID列表
     */
    void saveRelatedInterview(Long courseDesignId, List<Long> interviewIds);

}
